[beta] Mark an asset as missing.

Mark an asset as missing. Optionally specify a note and notification recipients who will receive email updates.

Rate limit: 100 requests/min (learn more about rate limits here).

To use this endpoint, select Write Assets under the Assets category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

POST /fleet/assets/device-recovery/{id}/missing

[beta] Mark an asset as missing.

cURL

curl --request POST \
  --url https://api.samsara.com/fleet/assets/device-recovery/{id}/missing \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": "Asset was last seen at warehouse A",
  "notification_recipients": [
    {
      "notification_types": [
        "email"
      ],
      "user_id": 1234
    }
  ]
}
'

200

{
  "data": {
    "id": "12345",
    "name": "Trailer-A1234",
    "updated_at_ms": 1609459200000,
    "initiated_at_ms": 1609459200000,
    "initiated_by_user_id": 1234,
    "note": "Asset was last seen at warehouse A",
    "notification_recipients": [
      {
        "email": "[e-mail]",
        "name": "Jane Doe",
        "notification_types": [
          "email"
        ],
        "user_id": 1234
      }
    ],
    "update_source": "dashboard",
    "updated_by_user_id": 1234
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

The ID of the asset. This can be a Samsara internal ID or an external ID in the format key:value.

Body

application/json

Request body for marking an asset as missing.

note · string

Optional note when marking asset as missing.

Example:

"Asset was last seen at warehouse A"

notification_recipients · object[]

List of users to notify when asset is marked as missing.

Show child attributes

Example:

[
  {
    "notification_types": ["email"],
    "user_id": 1234
  }
]

Response

200

application/json

OK response.

data · object · required

An asset currently marked as missing, including notification recipients.

Show child attributes